
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of REPORTLOG.CGI</TITLE>
</HEAD><BODY>
<H1>REPORTLOG.CGI</H1>
Section: User Commands  (1)<BR>Updated: Version 4.3.13:  7 Jan 2014<BR><A HREF="#index">Index</A>
<A HREF="../index.html">Return to Main Contents</A><HR>

<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>

reportlog.cgi - CGI program to report service availability log
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>

<B>reportlog.cgi</B>

<P>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>

<B>reportlog.cgi</B>
is invoked as a CGI script via the reportlog.sh CGI wrapper.
Based on the parameters it receives, it generates an
availability report for a specific host-service combination
for the requested time-period. The availability report 
includes a calculation of the availability percentage (split
out on percent green, yellow, red time), and an eventlog for
the period listing the status changes that have occurred to
allow for drill-down to the test reports that indicate a
problem. Access to the individual historical status logs
go via the
<I><A HREF="../man1/svcstatus.cgi.1.html">svcstatus.cgi</A>(1)</I>

CGI script.
<P>
reportlog.cgi is passed a QUERY_STRING environment variable 
with the following parameters:
<P>
<BR>&nbsp;&nbsp;&nbsp;HOSTSVC&nbsp;(the&nbsp;host&nbsp;and&nbsp;service&nbsp;to&nbsp;report&nbsp;on)
<BR>&nbsp;&nbsp;&nbsp;STYLE&nbsp;(report&nbsp;style:&nbsp;&quot;crit&quot;,&nbsp;&quot;non-crit&quot;,&nbsp;&quot;all&quot;)
<BR>&nbsp;&nbsp;&nbsp;ST&nbsp;(starttime&nbsp;in&nbsp;seconds&nbsp;since&nbsp;1-1-1970&nbsp;00:00&nbsp;UTC)
<BR>&nbsp;&nbsp;&nbsp;END&nbsp;(endtime&nbsp;in&nbsp;seconds&nbsp;since&nbsp;1-1-1970&nbsp;00:00&nbsp;UTC)
<P>
The following non-standard parameters are handled by the
Xymon version of history.cgi:
<P>
<BR>&nbsp;&nbsp;&nbsp;IP&nbsp;(IP&nbsp;address&nbsp;of&nbsp;host&nbsp;-&nbsp;for&nbsp;display&nbsp;purposes&nbsp;only)
<BR>&nbsp;&nbsp;&nbsp;REPORTTIME&nbsp;(the&nbsp;REPORTTIME:&nbsp;setting&nbsp;for&nbsp;this&nbsp;host)
<BR>&nbsp;&nbsp;&nbsp;WARNPCT&nbsp;(the&nbsp;WARNPCT:&nbsp;setting&nbsp;for&nbsp;this&nbsp;host)
<P>
The REPORTTIME and WARNPCT options are taken from the
<I><A HREF="../man5/hosts.cfg.5.html">hosts.cfg</A>(5)</I>

definition for the host, or the defaults are used. These
modify the availability calculation to handle reporting
against agreed Service Level Agreements re. the time of
day when the service must be available, and the agreed
availability level.
<P>
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>

<DL COMPACT>
<DT>--env=FILENAME<DD>
Loads environment from FILENAME before executing the CGI.
<P>
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>SEE ALSO</H2>

<A HREF="../man5/hosts.cfg.5.html">hosts.cfg</A>(5), <A HREF="../man5/xymonserver.cfg.5.html">xymonserver.cfg</A>(5), <A HREF="../man1/svcstatus.cgi.1.html">svcstatus.cgi</A>(1)
<P>
<P>

<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT><A HREF="#lbAB">NAME</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 09:25:35 GMT, January 07, 2014
</BODY>
</HTML>
